home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / imprint.z / imprint
Encoding:
Text File  |  2002-10-03  |  20.9 KB  |  463 lines
  1.  
  2.  
  3.  
  4. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      imprint - converts text files to PostScript, similar to Adobe
  10.      enscript(tm)
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      iiiimmmmpppprrrriiiinnnntttt [----1111] [----2222] [----BBBB] [----bbbb headerText]
  14.              [----cccc] [----dddd printerName] [----FFFF hfontNameSize]
  15.              [----ffff fontNameSize] [----GGGG] [----gggg] [----hhhh]
  16.              [----LLLL maxLines] [----llll] [----mmmm] [----nnnn numCopies]
  17.              [----oooo printerOptions] [----pppp outFilename] [----qqqq]
  18.              [----rrrr] [----RRRR] [----tttt bannerTitle] [----wwww] [----MMMM]
  19.              [text file ...]
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _i_m_p_r_i_n_t formats text files using the PostScript page description language
  23.      and prints these files on a PostScript capable printer.  The program
  24.      provides a wide variety of formatting options including multiple column
  25.      output, page rotation, font selection and page decoration.
  26.  
  27.    TTTTeeeexxxxtttt FFFFiiiilllleeee IIIInnnnppppuuuutttt
  28.      One or more text files can be specified on the command line. If no files
  29.      are specified on the command line, _i_m_p_r_i_n_t will read from the standard
  30.      input. Currently, _i_m_p_r_i_n_t can accept plain text files in a number of
  31.      languages. The program has successfully formatted English, French,
  32.      German, and Russian (cyrillic) text files and theoretically should be
  33.      able to handle any language that can be expressed using an Adobe Type 1
  34.      font in a horizontal writing direction.  _i_m_p_r_i_n_t cannot currently handle
  35.      Adobe Type 0 composite fonts or vertical writing directions.
  36.  
  37.      Besides plain text files, _i_m_p_r_i_n_t can accept text files that contain
  38.      formatting control characters and special escape sequences. The most
  39.      common example of such files are formatted _n_r_o_f_f manual pages.  _i_m_p_r_i_n_t
  40.      has successfully handled the complex formatting produced by the _t_b_l and
  41.      _e_q_n programs. The following control characters and escape sequences are
  42.      recognized by _i_m_p_r_i_n_t:
  43.  
  44.              NNNNaaaammmmeeee        CCCChhhhaaaarrrr   CCCCooooddddeeee   DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  45.              _________________________________________________________
  46.              Null               0x00   No action
  47.              Bell        ^G     0x07   Audible bell
  48.              Backspace   ^H     0x08   Reverse one character
  49.              H Tab       ^I     0x09   Forward to next multiple of 8
  50.              Newline     ^J     0x0A   Start new line
  51.              V Tab       ^K     0x0B   Down one line
  52.              Formfeed    ^L     0x0C   Begin new page or column
  53.              Return      ^M     0x0D   Reverse to start of line
  54.              Shift Out   ^N     0x0E   No action
  55.              Shift In    ^O     0x0F   No action
  56.              Esc                0x1B   Begin escape sequence
  57.              Esc-7                     Reverse full line feed
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  71.  
  72.  
  73.  
  74.              Esc-8                     Reverse half line feed
  75.              Esc-9                     Forward half line feed
  76.              Esc-D                     Guady header left box text
  77.              Esc-H                     Gaudy header filename area text
  78.              Esc-U                     Gaudy user comment area text
  79.              Esc-F                     Font change sequence
  80.  
  81.      See the SSSSppppeeeecccciiiiaaaallll EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeeessss section below for details on the Esc-D,
  82.      Esc-H, Esc-U and Esc-F sequences.
  83.  
  84.      Control characters and escape sequences not listed above will cause
  85.      _i_m_p_r_i_n_t to issue a warning indicating the offending character and its
  86.      location in the text file. To prevent inadvertently attempting to format
  87.      a binary file, _i_m_p_r_i_n_t will terminate the processing of any file that
  88.      contains more than fifty unrecognized characters unless the ----gggg option has
  89.      been specified (see below). To ensure the proper processing of text files
  90.      the international locale should be established either by setting the LLLLAAAANNNNGGGG
  91.      environment variable prior to running _i_m_p_r_i_n_t.
  92.  
  93.    PPPPoooossssttttSSSSccccrrrriiiipppptttt OOOOuuuuttttppppuuuutttt
  94.      _i_m_p_r_i_n_t produces Level 1 PostScript code formatted in compliance with the
  95.      Adobe Document Structuring Conventions, Version 3.0. The output
  96.      PostScript data sent to the printer is 7-bit clean even when the input
  97.      data is not.
  98.  
  99.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  100.      ----1111        Format text into a single column. This is the default.
  101.  
  102.      ----2222        Format text into two columns. Typically, when using two
  103.                columns, the font size should be reduced to avoid excessive
  104.                line wrapping.
  105.  
  106.      ----BBBB        By default, _i_m_p_r_i_n_t places a simple header at the top of each
  107.                page.  This header consists of the date, time, file pathname
  108.                and page number.  Specifying the ----BBBB switch omits the header.
  109.  
  110.      ----bbbb _h_e_a_d_e_r_T_e_x_t
  111.                Specifies a comment to be placed on the page header. For the
  112.                default header, the _h_e_a_d_e_r_T_e_x_t will replace the file pathname.
  113.                If the ----GGGG option is specified, the _h_e_a_d_e_r_T_e_x_t will be placed
  114.                above the file pathname.
  115.  
  116.      ----cccc        By default, _i_m_p_r_i_n_t wraps text lines that are too long for the
  117.                column. The ----cccc option causes long text lines to be clipped
  118.                rather than wrapped to the next line.
  119.  
  120.      ----dddd _p_r_i_n_t_e_r_N_a_m_e
  121.                If the ----pppp option is not specified, ----dddd specifies a destination
  122.                printer for which the text files are to be formatted and
  123.                printed.  _p_r_i_n_t_e_r_n_a_m_e is the name of the printer as registered
  124.                with the printer spooling system (see _p_r_i_n_t_e_r_s(1M) for
  125.                information on printer installation). The printer may be
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  137.  
  138.  
  139.  
  140.                physically attached to the system or it may be a network
  141.                printer. If a printer has not been specified, the system
  142.                default printer will be used. If the ----pppp option is specified,
  143.                the text files are formatted for the specified printer but are
  144.                sent instead to the specified output file. In this case, if a
  145.                printer has not been specified, the text files are formatted
  146.                assuming a generic environment.
  147.  
  148.      ----FFFF _h_f_o_n_t_N_a_m_e_S_i_z_e
  149.                Specifies the font name and point size to use for the default
  150.                page header.  The default header font is Courier-Bold10. Note
  151.                that this option has no effect when the gaudy header is used.
  152.                See the FFFFoooonnnnttttssss section below for additional information.
  153.  
  154.      ----ffff _f_o_n_t_N_a_m_e_S_i_z_e
  155.                Specifies the font name and point size to use for the body
  156.                text. The default body font is normally Courier10. When rotated
  157.                (----rrrr), two-column (----2222) formatting is specified, the default body
  158.                font becomes Courier7. See the FFFFoooonnnnttttssss section below for
  159.                additional information.
  160.  
  161.      ----GGGG        Provides a more elaborate page decoration and header than the
  162.                default header.  The date, time, file pathname and page number
  163.                are provided along with a space for a user supplied comment
  164.                (see ----bbbb).
  165.  
  166.      ----gggg        _i_m_p_r_i_n_t recognizes plain text characters, a number of common
  167.                control characters and a set of special escape sequences. All
  168.                other characters cause a warning message to be issued
  169.                identifying the character and its location in the input file.
  170.                If more than 50 characters in a file are unrecognized, the
  171.                processing of that file terminates. This prevents inadvertently
  172.                attempting to format a binary file. If a file is to be
  173.                formatted that contains unrecognizable characters, the ----gggg
  174.                option should be specified. This silences all unrecognized
  175.                character warnings and allows an unlimited number of
  176.                unrecognized characters to be processed.
  177.  
  178.      ----hhhh        Specifies that a banner page should not be printed.
  179.  
  180.      ----LLLL _m_a_x_L_i_n_e_s
  181.                Normally, _i_m_p_r_i_n_t places as many lines of text on the page as
  182.                will fit (equivalent to specifying _m_a_x_L_i_n_e_s as 0).  The ----LLLL
  183.                option places a maximum limit on the number of lines placed on
  184.                a page or column.  The number of lines actually produced will
  185.                be either _m_a_x_L_i_n_e_s or the number that can fit on the page
  186.                whichever is less.
  187.  
  188.      ----llll        Specifies a line printer emulation mode. In this mode page
  189.                headers are omitted and 66 lines per page are printed. This
  190.                mode should be specified when printing preformatted _n_r_o_f_f
  191.                manual pages.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  203.  
  204.  
  205.  
  206.      ----mmmm        Causes mail to be sent after the text files have been printed.
  207.                This option has no effect when the ----pppp option is specified.
  208.  
  209.      ----nnnn _n_u_m_C_o_p_i_e_s
  210.                Prints _n_u_m_C_o_p_i_e_s of each page. One copy is the default. When
  211.                the ----pppp option is specified a single copy of the output is
  212.                provided and the ----nnnn option is ignored.
  213.  
  214.      ----oooo _p_r_i_n_t_e_r_O_p_t_i_o_n_s
  215.                Allows printer specific options to be specified. See the _l_p(1)
  216.                manual page for details on this option.
  217.  
  218.      ----pppp _o_u_t_F_i_l_e_n_a_m_e
  219.                Sends the PostScript output to the specified file rather than
  220.                to a printer. If _o_u_t_F_i_l_e_n_a_m_e is specified as '-', the output is
  221.                sent to the standard output. If a printer has been specified,
  222.                the output is formatted for that printer (i.e margins, page
  223.                size, etc.). If a printer has not been specified, a generic
  224.                environment is assumed.
  225.  
  226.      ----qqqq        Normally, _i_m_p_r_i_n_t displays summary information when it has
  227.                completed formatting the text files. The ----qqqq option runs the
  228.                program in silent mode and no summary information is printed.
  229.                Errors and warnings cannot be silenced.
  230.  
  231.      ----RRRR        Specifies non-rotated orientation and is the default. This is
  232.                typically a portrait orientation.
  233.  
  234.      ----rrrr        Specifies that the text columns should be rotated 90 degrees
  235.                counter- clockwise. This is typically a landscape orientation.
  236.  
  237.      ----tttt _b_a_n_n_e_r_T_i_t_l_e
  238.                Specifies a banner page title for the print job.
  239.  
  240.      ----wwww        Causes a message to be sent after the text files have been
  241.                printed. This option has no effect when the ----pppp option is
  242.                specified.
  243.  
  244.      ----MMMM        If the input file(s) is named in the commandline, then the
  245.                file's last modified timestamp will be printed in the page
  246.                header. This overrides any header text specified with the -b
  247.                option.
  248.  
  249.    FFFFoooonnnnttttssss
  250.      _i_m_p_r_i_n_t can utilize the fonts found in the directory /_u_s_r/_l_i_b/_D_P_S/_A_F_M.
  251.      The full font name may be specified or one of the font name abbreviations
  252.      listed in the table below may be used.
  253.  
  254.                     FFFFuuuullllllll NNNNaaaammmmeeee                      AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnn
  255.                     ___________________________________________
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  269.  
  270.  
  271.  
  272.                     Courier                        C
  273.                     Courier-Bold                   CB
  274.                     Courier-BoldOblique            CBO
  275.                     Courier-Oblique                CO
  276.                     Helvetica                      H
  277.                     Helvetica-Bold                 HB
  278.                     Helvetica-BoldOblique          HBO
  279.                     Helvetica-Oblique              HO
  280.                     Symbol                         S
  281.                     Times-Bold                     TB
  282.                     Times-BoldItalic               TBI
  283.                     Times-Italic                   TI
  284.                     Times-Roman                    T
  285.                     AvantGarde-Book                AGB
  286.                     AvantGarde-BookOblique         AGBO
  287.                     AvantGarde-Demi                AGD
  288.                     AvantGarde-DemiOblique         AGDO
  289.                     Bookman-Demi                   BD
  290.                     Bookman-DemiItalic             BDI
  291.                     Bookman-Light                  BL
  292.                     Bookman-LightItalic            BLI
  293.                     Helvetica-Narrow               HN
  294.                     Helvetica-Narrow-Bold          HNB
  295.                     Helvetica-Narrow-BoldOblique   HNBO
  296.                     Helvetica-Narrow-Oblique       HNO
  297.                     NewCenturySchlbk-Bold          NCSB
  298.                     NewCenturySchlbk-BoldItalic    NCSBI
  299.                     NewCenturySchlbk-Italic        NCSI
  300.                     NewCenturySchlbk-Roman         NCSR
  301.                     Palatino-Bold                  PB
  302.                     Palatino-BoldItalic            PBI
  303.                     Palatino-Italic                PI
  304.                     Palatino-Roman                 PR
  305.                     ZapfChancery-MediumItalic      ZCMI
  306.                     ZapfDingbats                   ZD
  307.  
  308.      If a font is specified that is not found in the font directory, Courier
  309.      will be substituted. Note that a fixed-width font such as Courier should
  310.      be used when printing tabular material and preformatted manual pages.
  311.  
  312.    SSSSppppeeeecccciiiiaaaallll EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeeessss
  313.      _i_m_p_r_i_n_t recognizes a number of special escape sequences. These sequences
  314.      can be embedded in a text file to change header text and switch fonts
  315.      during processing of  the file.  The escape sequences are compatible with
  316.      those used by the _e_n_s_c_r_i_p_t program from the Adobe TranScript product. The
  317.      sequences are:
  318.  
  319.             EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeee      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  320.             __________________________________________________________
  321.             Esc-D(_t_o_p)(_b_o_t_t_o_m)   Gaudy header left box text
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  335.  
  336.  
  337.  
  338.             Esc-H_h_e_a_d_e_r_T_e_x_t      Gaudy header filename area text
  339.             Esc-U_c_o_m_m_e_n_t_T_e_x_t     Gaudy user comment area text
  340.             Esc-F_c               Font change sequence (see _t_e_x_t_2_p_s(1))
  341.  
  342. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  343.      1.   Printing a preformatted manual page to the default printer:
  344.  
  345.           pcat csh.z | imprint -l
  346.  
  347.  
  348.      2.   Printing a file to the printer 'dj' in two column, landscape mode
  349.           with a gaudy header:
  350.  
  351.           imprint -d dj -2rG /etc/passwd
  352.  
  353.  
  354. NNNNOOOOTTTTEEEESSSS
  355.      1.   the _i_m_p_r_i_n_t program runs the _t_e_x_t_2_p_s program to perform the work for
  356.           formatting the text files and the _l_p program to print them. Refer to
  357.           the manual pages for these programs for detailed information on
  358.           formatting and printing issues.
  359.  
  360.      2.   The PostScript output produced by _i_m_p_r_i_n_t conforms to the Adobe
  361.           PostScript Document Structuring Conventions Version 3.0 as specified
  362.           in Appendix G of the "PostScript Language Reference Manual", 2nd
  363.           edition.
  364.  
  365.      3.   If _i_m_p_r_i_n_t is given an unrecognized or incomplete command line
  366.           option switch, it will print a warning message to the standard
  367.           error, ignore the option and continue processing.
  368.  
  369.      4.   If a file is specified on the command line, _i_m_p_r_i_n_t will not read
  370.           its stdin for text files.
  371.  
  372.      5.   _i_m_p_r_i_n_t can only process a single file when reading from standard
  373.           input.
  374.  
  375.      6.   Use a of proportional spaced font or dynamically changing fonts when
  376.           formatting manual pages can cause misformatting of tables.
  377.  
  378. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  379.      If the environment variable IIIIMMMMPPPPRRRRIIIINNNNTTTT is set, _i_m_p_r_i_n_t will treat the
  380.      contents of this variable as command line options. For example, if
  381.      IIIIMMMMPPPPRRRRIIIINNNNTTTT has been set to '-2rG', _i_m_p_r_i_n_t will print in two-column, rotated
  382.      mode with a gaudy header whenever it is invoked. Options specified on the
  383.      command line override environment variable options.
  384.  
  385. FFFFIIIILLLLEEEESSSS
  386.      /usr/sbin/imprint         Program file
  387.      /usr/lib/print/text2ps    Text formatting filter
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        IIIIMMMMPPPPRRRRIIIINNNNTTTT((((1111))))
  401.  
  402.  
  403.  
  404.      /usr/bin/lp               Printing program
  405.  
  406. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  407.      text2ps(1), lp(1)
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.